﻿<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>FileGetSize</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link href="../css/commands.css" rel="stylesheet" type="text/css">
<link href="../css/print.css" rel="stylesheet" type="text/css" media="print">
</head>
<body>

<h1>FileGetSize</h1>

<p>返回文件的大小。</p>

<p class="CommandSyntax">FileGetSize, OutputVar [, Filename, Units] </p>
<h3>参数 </h3>
<table border="1" width="100%" cellspacing="0" cellpadding="3" bordercolor="#C0C0C0">
  <tr>
    <td>OutputVar</td>
    <td>存储返回值(该文件的大小)的变量名(其结果进行四舍五入)。</td>
  </tr>
  <tr>
    <td width="15%">Filename</td>
    <td width="85%">目标文件的文件名，如果绝对路径没有指定的话假定在<a href="../Variables.htm#WorkingDir"> %A_WorkingDir%(工作目录)</a> 中。如果忽略不写，当前 <a href="LoopFile.htm">File-Loop</a>中 最深处的文件将被替代使用。</td>
  </tr>
  <tr>
    <td>Units</td>
    <td><p>如果这个参数出现，那么它将使得最终返回的结果遵循以下的方案(否则将以字节的形式显示)：<br>
      K = 千字节<br>
      M = 兆字节</p>    </td>
  </tr>
</table>
<h3>ErrorLevel</h3>
<p>如果有问题的话 <a href="../misc/ErrorLevel.htm">ErrorLevel</a> 被设置为1，否则设置为0。</p>
<h3>注意</h3>
<p>支持大于4G字节的文件(甚至就算参数<em>Units</em>是字节也可以)。</p>
<p>如果目标文件是一个目录的话，不论操作系统把它当作什么(可能是0)都会返回它的大小。</p>
<p>如果要计算文件夹的大小，像下面这个例子一样计算里面所有的文件：</p>
<pre>SetBatchLines, -1  <em>; 使得操作以最大的速度运行。</em>
FolderSize = 0
FileSelectFolder, WhichFolder  <em>; 让用户选择一个目录。</em>
Loop, %WhichFolder%\*.*, , 1
    FolderSize += %A_LoopFileSize%
MsgBox Size of %WhichFolder% is %FolderSize% bytes.</pre>
<h3>相关命令</h3>
<p><a href="FileGetAttrib.htm">FileGetAttrib</a>, <a href="FileSetAttrib.htm">FileSetAttrib</a>, <a href="FileGetTime.htm">FileGetTime</a>, <a href="FileSetTime.htm">FileSetTime</a>, <a href="FileGetVersion.htm">FileGetVersion</a><a href="FileGetVersion.htm"></a>, <a href="LoopFile.htm">File-loop</a></p>
<h3>示例</h3>
<pre class="NoIndent">FileGetSize, size, C:\My Documents\test.doc  <em>; 以字节的形式返回Test.doc文件的大小</em>
FileGetSize, size, C:\My Documents\test.doc, K  <em>; 以千字节的形式返回Test.doc文件的大小</em></pre>


</body>
</html>
